home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / bgpck12.zip / BGPCK.DOC < prev    next >
Text File  |  1990-06-27  |  10KB  |  211 lines
  1.  
  2.               VOICE               B.J. GUILLOT               MODEM
  3.          (713) 893-9123       2611 RUSHWOOD CIRCLE      (713) 893-9124
  4.                              HOUSTON, TX 77067-1941
  5.  
  6.             Copyright B.J. Guillot (C) 1990 - All Rights Reserved
  7.  
  8.          =============================================================
  9.          BGPCK 1.2                                           26 JUN 90
  10.          =============================================================
  11.  
  12.          -------------------------------------------------------------
  13.                                    ABSTRACT
  14.          -------------------------------------------------------------
  15.  
  16.          BGPCK uses the users  last read pointers  from the areas they
  17.          are joined into  and  generates  a zip file that contains any
  18.          new messages.  It is similar to the OZ FASTMAIL program,  but
  19.          gives the users the ability to  reply to messages  when using
  20.          BGRDR or a compatible reader program.
  21.  
  22.          It gives users the ability to read messages on their own time
  23.          freeing up time on your board as well as  letting  them  have
  24.          the change to use their favorite text editor as well.   BGPCK
  25.          works with both GT 14 and 15 series and with both versions of
  26.          GT, it gives the users full features of GT 15,  including the
  27.          ability to quote and unjoin areas at will.
  28.  
  29.          -------------------------------------------------------------
  30.                         EXECUTION AND COMMAND PARAMETERS
  31.          -------------------------------------------------------------
  32.  
  33.          BGPCK now requires a configuration file.  Example fields:
  34.  
  35.          tranquil              board id, 8 characters max
  36.          c:\gt\bgpck           work directory
  37.          c:\util               path where pkzip/pkunzip are located
  38.          B.J._Guillot          sysop name - underscored - correct case
  39.          150                   maximum messages packed per area
  40.          1024                  minimum disk k required to run
  41.          c:\util\dwredir.com   pathname of dwredir; only necessary if
  42.                                you are using doorway 2.06+
  43.  
  44.          For BGPCK to run, the configuration file must be located in
  45.          the GTPATH directory.
  46.  
  47.          The space bar character is treated as a comment character.
  48.  
  49.          The board ID must be no longer than eight characters.  It is
  50.          used as the filename of the files created with BGPCK.  You
  51.          should try to make your board ID unique to your area; i.e.,
  52.          two boards both using the name of "ULTIMATE" in the same
  53.          area code could be dreadful for users if they wish to use
  54.          BGPCK on both of those boards.
  55.  
  56.          If you wish to run BGPCK on GT 13/14 systems, just must put a
  57.          dollar sign in front of the board identifaction line.  Ex:
  58.  
  59.          TRANQUIL               use the door with GT 15 systems
  60.          $TRANQUIL              use the door with GT 13/14 systems
  61.  
  62.          The sysop name should have an underscore replacing any
  63.          spaces in the sysop name or BGPCK will think the sysop's
  64.          last name is a comment.
  65.  
  66.          The maximum messages per conference give the sysop some
  67.          control of what is going on.  I recommend you use a number
  68.          no greater than 100.  The space the messages take add up
  69.          very quickly.  (One message takes a minmim of 256 bytes).
  70.          If more than 100 messages are in a base, BGPCK will pull
  71.          out the first 100, not the last 100.  The user can call
  72.          back and get the other messages left over later rather than
  73.          having to reset the pointers manually.  This may change.
  74.  
  75.          The minimum disk space required also gives you some control.
  76.          The number must be in kilobytes; i.e., 1024 would be one
  77.          megabyte.  I would recommend that you at least have one
  78.          megabyte to do work with.  If you with anything lower, you
  79.          risk the possibility of a crash from low disk space.  The
  80.          user will be notified if disk space is too low on the host
  81.          system.
  82.  
  83.          The last two fields are new.  The upload and download
  84.          directories are provided so that the sysop can use BGRDR
  85.          without having to move files around.
  86.  
  87.          Syntax:  BGPCK comport [/D /E /G /M]
  88.  
  89.          BGPCK uses one command line parameter.  The com port that
  90.          will be used.  You can use...
  91.  
  92.          BGPCK %2
  93.  
  94.          ...to care of everything for you assing GATEWAY was activated
  95.          before hand.
  96.  
  97.          The /D parameter informs BGPCK to use DOORWAY and the DWREDIR
  98.          program.
  99.          The /E parameter informs BGPCK to use DSZ.EXE.
  100.          The /G parameter informs BGPCK that YMODEM-G may be used.
  101.          The /M parameter informs BGPCK that Moby Turbo may be used.
  102.  
  103.          -------------------------------------------------------------
  104.                            FILES INCLUDED / USED
  105.          -------------------------------------------------------------
  106.  
  107.          BGPCK.EXE - Main Program
  108.          BGPCK.DOC - This documentation file
  109.          BGPCK.CNF - Sample configuration file
  110.          BGPCK.HLP - Sample help file
  111.  
  112.          DSZ *must* be in your GTPATH directory, where netmail requires
  113.          it to be.
  114.  
  115.          BGPCK generates *.MSG files which are then compressed with
  116.          PKZIP into *.RDR files.  BGRDR, or a compatible reader, reads
  117.          the *.MSG files after unpacking the *.MSG files.  BGRDR makes
  118.          reply files, *.BAG, and zips them up as *.PCK files.
  119.  
  120.          *All* files should reside in the GTPATH directory.  The work
  121.          directory is used only for what it states, work, and should
  122.          be empty when not in use.
  123.  
  124.          The BGPCK.CTL file is created and stored in the GTPATH
  125.          directory.  This contains the users configuration information
  126.          and date of the last packet uploaded so duplicates don't
  127.          pop up.
  128.  
  129.          A total of 255 message bases are supported.
  130.  
  131.          BGPCK keeps a log file in the GTPATH directory.  You can deal
  132.          with the log file in anyway you see fit; BGPCK.LOG.
  133.  
  134.          A sample batch file that you may use to execute this door:
  135.  
  136.          @echo off
  137.          rem ** Loading MailPack Door **
  138.          %1 gate%2
  139.          bgpck %2
  140.          %1 con
  141.  
  142.          If you would be interested in writing your own reader or door
  143.          that will be compatible with mine, you are free to do so.
  144.          You will need to contact me to get the specs.
  145.  
  146.          -------------------------------------------------------------
  147.                     CARRIER MONITORING AND DOOR ROUTINES
  148.          -------------------------------------------------------------
  149.  
  150.          You may logon as a local user and open the door.  The CD
  151.          pin will not be checked.  If you are logging on locally,
  152.          however, if you wish to upload replies, they must be in
  153.          the work directory, as DSZ.COM is not executed.
  154.  
  155.          BGPCK does not support its own communcation routines.  It
  156.          must use a "helping" program such as Gateway or Doorway to be
  157.          seen by the remote user.
  158.  
  159.          If you use DOORWAY, be sure to include the /D parameter and
  160.          include the DWREDIR line in the BGPCK.CNF file.  You *must*
  161.          be using DOORWAY 2.06 or above with BGPCK.  Doorway 2.05 and
  162.          below WILL NOT WORK.  (2.06 beta is currently available on
  163.          Marshall's system for registered users).
  164.  
  165.          If you have your com port locked at a high baudrate and are
  166.          not using GT 15.50, estimated download times on files will
  167.          not be reliable.  If you are using GT 15.50, BGPCK will send
  168.          DSZ the locked DTE baud rate and use the DCE user baud
  169.          rate for calculating download times.
  170.  
  171.          If carrier is dropped during the door, the door will
  172.          "gracefully" return to GT and exit with an errorlevel of 1.
  173.  
  174.          My carrier monitoring routine was a routine out of the ASYNC
  175.          TP communications library.  It must be called several times
  176.          during the program.  For interested programmers, here is the
  177.          coding that is necessary:
  178.  
  179.          const c_portaddr : array[1..4] of word =
  180.                 ($03F8, $02F8, $03E8, $02E8);
  181.  
  182.          var COMPORT : byte;
  183.  
  184.          function dcdstat : boolean;
  185.          begin
  186.                 dcdstat := port[c_portaddr[COMPORT]+6] and $80) > 0
  187.          end;
  188.  
  189.          { the +6 is a constant that is used on the 8250 uart }
  190.          { COMPORT is a  numerical value  ranging from 1 to 4 }
  191.  
  192.          -------------------------------------------------------------
  193.                              OTHER INFORMATION
  194.          -------------------------------------------------------------
  195.  
  196.          This program was written with Borland's Turbo Pascal 5.5  and
  197.          has been compressed with LZEXE 0.91.
  198.  
  199.          If you have any suggestions or comments please  address  them
  200.          to  me via netmail or any appropriate echomail conference, or
  201.          via a direct voice or BBS phone call.
  202.  
  203.          There is no registration  required.   This program is free to
  204.          use, provided that you do not alter or reverse  engineer  the
  205.          program in anyway  what so ever.
  206.  
  207.          I may be contacted at AFSN 440/003 or RelayNet TRANQUIL.
  208.  
  209.          Regards,                                       AfsNet 440/003
  210.          B.J. Guillot                                   (713) 893-9124
  211.